Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 10 - Group Objects / Group Objects Reference

Group Objects Routines / Managing Groups

Q3Group_AddObjectAfter

You can use the Q3Group_AddObjectAfter function to add an object to a group, positioning it after a certain object already in the group.

TQ3GroupPosition Q3Group_AddObjectAfter (
TQ3GroupObject group, 
TQ3GroupPosition position, 
TQ3Object object);

group

A group.

position

A group position.

object

An object.

DESCRIPTION

The Q3Group_AddObjectAfter function inserts the object specified by the object parameter into the group specified by the group parameter, after the group position specified by the position parameter. Q3Group_AddObjectAfter returns, as its function result, the new position of the object in the group. If an error occurs during the insertion of the object into the group, Q3Group_AddObjectAfter returns NULL.

ERRORS

kQ3ErrorInvalidObject
kQ3ErrorInvalidPositionForGroup
kQ3ErrorOutOfMemory